<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
<TITLE>IBM Visualization Data Explorer Programmer&#39;s Reference</TITLE>

<META HTTP-EQUIV="abstract" CONTENT="IBM Visualization Data Explorer
Programmer&#39;s Reference">
<META HTTP-EQUIV="contact" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="owner" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="updated" CONTENT="Tue, 16 Sep 1997 ">
<META HTTP-EQUIV="review" CONTENT="Fri, 14 Aug 1998 ">

<META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA
MINING">
<meta http-equiv="content-type" content="text/html;charset=ISO-8859-1">
</HEAD><BODY BGCOLOR="#FFFFFF">

<A NAME="Top_Of_Page"></A>
<H1>IBM Visualization Data Explorer Programmer&#39;s Reference</H1>
<B>&#91; <A HREF="#Bot_Of_Page">Bottom of Page</A> &#124; <A
HREF="progu204.htm">Previous Page</A> &#124; <A HREF="progu206.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B><HR><P>
<H3><A NAME="HDRDXGTE" HREF="progu097.htm#PToC_299">DXGetType</A></H3>
<A NAME="IDX1802"></A>
<A NAME="IDX1803"></A>
<P><STRONG>Function</STRONG>
<P>
Returns the type, category, rank, and shape of an Object.
<P><STRONG>Syntax</STRONG>
<BR>
<TT><STRONG><BR>
&#35;include &lt;dx/dx.h&gt;<BR>
<P><BR>
Object DXGetType(Object o, Type *t, Category *c, int *rank, int *shape)<BR>
</STRONG></TT><BR>
<P><STRONG>Functional Details</STRONG>
If
<TT><STRONG>
t
</STRONG></TT>
is not
<TT><STRONG>NULL</STRONG></TT>,
this routine returns the type of
<TT><STRONG>
g
</STRONG></TT>
in <TT><STRONG>*t</STRONG></TT>.  If
<TT><STRONG>
c
</STRONG></TT>
is not
<TT><STRONG>NULL</STRONG></TT>,
it returns the type of
<TT><STRONG>
g
</STRONG></TT>
in <TT><STRONG>*c</STRONG></TT>.  If
<TT><STRONG>
rank
</STRONG></TT>
is not
<TT><STRONG>NULL</STRONG></TT>,
it returns the rank of
<TT><STRONG>
g
</STRONG></TT>
in <TT><STRONG>*rank</STRONG></TT>.  If
<TT><STRONG>
shape
</STRONG></TT>
is not
<TT><STRONG>NULL</STRONG></TT>,
it returns the shape Array of
<TT><STRONG>
g
</STRONG></TT>
in
<TT><STRONG>*shape</STRONG></TT>.  <TT><STRONG>shape</STRONG></TT>
must point to an Array at least
<TT><STRONG>*rank</STRONG></TT> in length.
<P>
The type is one of the following:
<PRE><STRONG>
TYPE_BYTE            TYPE_HYPER        TYPE_SHORT
TYPE_UBYTE           TYPE_INT          TYPE_USHORT
TYPE_DOUBLE          TYPE_UINT         TYPE_STRING
TYPE_FLOAT
</STRONG>
</PRE>
<P>
The category is either <TT><STRONG>CATEGORY_REAL</STRONG></TT> or
<TT><STRONG>CATEGORY_COMPLEX</STRONG></TT>.
<P>
Array Objects are always typed.  Fields are typed if they contain
a "data" component; their type is the same as that of the
"data" component.  Series, MultiGrids, and Composite Fields
are typed if they contain typed Fields.  Generic Groups may be typed
by explicitly calling
<TT><STRONG>DXSetGroupType</STRONG></TT>.  If typed, all
Fields contained in the Group must match the type.
Other Objects do not contain type information.
<P><STRONG>Return Value</STRONG>
<P>
Returns <TT><STRONG>o</STRONG></TT> only if there is a type associated with
<TT><STRONG>o</STRONG></TT> or returns <TT><STRONG>NULL</STRONG></TT>
without setting an error code.
<P><STRONG>See Also</STRONG>
<P>
<TT><STRONG>
<A HREF="progu157.htm#HDRDXGAI">DXGetArrayInfo</A>,
<A HREF="progu315.htm#HDRDXSGTV">DXSetGroupType, DXSetGroupTypeV</A>,
<A HREF="progu340.htm#HDRDXUGT">DXUnsetGroupType</A>
</STRONG></TT>
<P>
<A HREF="progu058.htm#HDRTY">"Setting Data Types"</A>.
<P><HR><B>&#91; <A HREF="#Top_Of_Page">Top of Page</A> &#124; <A
HREF="progu204.htm">Previous Page</A> &#124; <A HREF="progu206.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B> <br><b>&#91;<a
href="../allguide.htm">Data Explorer Documentation</a>&nbsp;&#124;&nbsp;<a
href="../qikguide.htm">QuickStart Guide</a>&nbsp;&#124;&nbsp;<a
href="../usrguide.htm">User&#39;s Guide</a>&nbsp;&#124;&nbsp;<a
href="../refguide.htm">User&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../proguide.htm">Programmer&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../insguide.htm">Installation and Configuration
Guide</a>&nbsp;&#93;</b><br><p><b>&#91;<a
href="http://www.research.ibm.com/dx">Data Explorer Home
Page</a>&#93;</b><p><HR ALIGN=LEFT WIDTH=600><b>&#91;<A
HREF="http://www.ibm.com/">IBM Home Page</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Orders/">Order</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Search/">Search</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Assist/">Contact IBM</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Legal/">Legal</A>&nbsp;&#93;</b><hr><p>
<A NAME="Bot_Of_Page"></A>
</BODY></HTML>
